home *** CD-ROM | disk | FTP | other *** search
/ Amiga Games 1996 July / Amiga Games 1996 #7.iso / spiele / publicdomain / tads / read.doc < prev    next >
Text File  |  1996-02-20  |  8KB  |  208 lines
  1. TADS, the Text Adventure Development System version 2.2
  2. Copyright (c) 1990, 1992 by Michael J. Roberts.  All rights reserved.
  3.  
  4. This package was prepared October 30, 1994.
  5.  
  6. This software is being distributed as shareware.  You may use and redistribute
  7. it subject to the usual shareware rules; see LICENSE.DOC for full details.
  8. You are requested to register your copy as described in LICENSE.DOC.  Please
  9. see ORDER.FRM for information on ordering this and other High Energy Software
  10. products.
  11.  
  12. We appreciate the concerns many people have about registering their shareware:
  13. authors move or just disappear.  This is why we use a post office box (at a
  14. REAL US Post Office!) to ensure that our address stays the same indefinitely.
  15. We have a big pile of TADS manuals waiting for your order, and plan to be in
  16. business for quite some time.  Please help us out by taking a manual off of
  17. our hands - you'll be glad you did!  If you have any questions or comments,
  18. we would love to hear from you; see ORDER.FRM for our address.  Thanks for
  19. your interest!
  20.  
  21.  
  22. Attention Version 1 Users!
  23. --------------------------
  24.  
  25. TADS Version 2 is intended to be compatible with games written for v1.
  26. However, there are a few differences.  If you experience any difficulty
  27. compiling a game that was working with v1, try using the "V1 Compatibility
  28. Mode" options.  You can enable full v1 compatibility mode by placing -1
  29. before your game name:
  30.  
  31.     tc -1 mygame
  32.  
  33. Most v1 games that have problems with v2 need only rename the new "do"
  34. keyword to run with v2; this can be done with these options:
  35.  
  36.     tc -1d _do_ mygame
  37.  
  38.  
  39. Documentation
  40. -------------
  41.  
  42. You should download the TADS Documentation archive, TADS2DOC.ZIP (on DOS)
  43. or TADS2DOC.SIT (on Macintosh) [note - these extensions may be changed if
  44. the sysop of your BBS or on-line service has repackaged the archive with
  45. a different compression tool].  This file contains overview documentation
  46. for TADS, as well as the source for "Ditch Day Drifter", a complete sample
  47. game.
  48.  
  49. Additional documentation is available to registered users.  When you
  50. register your copy of TADS, we'll send you the printed TADS Author's Manual,
  51. with over 200 pages of details about writing games with the system.  The
  52. Author's Manual contains numerous examples, and includes an entire chapter
  53. devoted to examples of programming common adventure scenarios.
  54.  
  55.  
  56. Getting Started
  57. ---------------
  58.  
  59. To get started on the system, install the executables in a directory on your
  60. path, and install the source files (*.T) wherever you please.  Compile "Ditch
  61. Day Drifter" by typing:
  62.  
  63.      tc ditch
  64.  
  65. Be sure that ADV.T is in your current directory.
  66.  
  67. Note that DITCH.T is part of the separate TADS Documentation archive;
  68. you should be able to get this archive from the same place you got the
  69. archive containing the TADS executables.
  70.  
  71. After you have compiled Ditch, run the game by typing:
  72.  
  73.      tr ditch
  74.  
  75. Please read DITCH.DOC for information on playing the game.  This file also
  76. describes many features of the run-time system, including the parser.
  77.  
  78.  
  79. Notes for DOS users
  80. -------------------
  81.  
  82. On PC's, you may edit command lines with the arrow keys and other standard
  83. editing keys.  Review Mode (described in DEEP.DOC) is activated with
  84. function key F1.
  85.  
  86. Saved games are stored in standard DOS files, by default in the current
  87. directory (the directory from which you start the game), so make sure
  88. you have free disk space before you begin playing.
  89.  
  90. If you have limited memory in your PC, you may need to adjust the
  91. compiler's memory usage so it fits.  If the compiler runs out of
  92. memory, it will tell you the amount of memory it is consuming and
  93. suggest that you run again with a lower -m option.  For example,
  94. if the compiler displays a message like this:
  95.  
  96.    *** Note for -m option:
  97.    *** Current cache size is 256000
  98.    ditch.t, line 3501: TADS-1: out of memory
  99.  
  100. you can run again by specifying a smaller size with the -m option:
  101.  
  102.    tc -m 200000 ditch
  103.  
  104. This tells the compiler to restrict its memory usage to 200,000 bytes,
  105. which it does by swapping excess space out to a disk file.  If the
  106. compiler is forced to swap, you can speed it up considerably by moving
  107. the swap file to a RAM disk in extended or expanded memory.  If your
  108. RAM disk is drive D, you can tell TADS to place the swap file on
  109. your RAM disk using the -tf option:
  110.  
  111.    tc -m 200000 -tf d:swap.dat ditch
  112.  
  113.  
  114. DOS Protected-Mode TADS
  115. -----------------------
  116.  
  117. The compiler, runtime, and debugger are available as DOS
  118. protected-mode commands.  The protected-mode versions are only
  119. capable of running on 80286 or newer processors -- they will not work
  120. on XT-type machines (which use 8086 processors).  The protected-mode
  121. versions can access up to 16 megabytes of memory, so they will allow
  122. much larger games; because they will not do as much swapping as the
  123. normal DOS versions, the protected- mode commands are usually much
  124. faster than the normal DOS versions with large games.
  125.  
  126. The protected-mode versions of the executables have the same names as
  127. the normal DOS versions plus an "X":
  128.  
  129.     Component     Normal DOS     Protected-mode
  130.                    Command          Command
  131.     ---------     ----------     --------------
  132.     compiler         tc               tcx
  133.     runtime          tr               trx
  134.     debugger         tdb              tdbx
  135.  
  136. The protected-mode commands work the same as their real-mode
  137. counterparts, and all command line options and arguments are the same
  138. for both versions.
  139.  
  140. The protected-mode commands use the Borland DOS extender software.
  141. This software is copyrighted by Borland and cannot be distributed
  142. except with Borland's permission.  The Borland license allows
  143. redistribution of the DOS extender with software created with a
  144. properly licensed copy of the Borland tools, which allows us to
  145. include the DOS extender software with TADS.  The files making up the
  146. Borland DOS extender are:
  147.  
  148.     dpmi16bi.ovl
  149.     rtm.exe
  150.  
  151. Before running any of the protected-mode commands, you must have
  152. these files in a directory on your DOS PATH.
  153.  
  154. The Borland DOS extender is compatible with most computers based on
  155. 286, 386, 486, or Pentium processors, and works properly with most
  156. memory managers (such as QEMM and EMM386), and with Microsoft Windows
  157. DOS windows when running in 386 Enhanced mode.  By its nature,
  158. though, the DOS extender software is sensitive to the specific
  159. hardware and software configuration of your computer, and may not
  160. work with certain computers, peripherals, or resident software.  If
  161. you experience any problems with the protected-mode versions, try
  162. removing any drivers, TSR's, and other resident software from your
  163. configuration.  Since the DOS extender is developed and maintained by
  164. Borland, not High Energy Software, we will not be able to correct any
  165. incompatibilities or other problems that are caused by the DOS
  166. extender itself.
  167.  
  168. To reduce the size of the shareware archive file, only the normal DOS
  169. versions of the TADS commands are included in the shareware
  170. distribution.  You do not need any additional software to run the
  171. normal DOS versions of the commands, and these versions will run on
  172. any IBM or 100% compatible DOS PC.
  173.  
  174.  
  175. For More Information
  176. --------------------
  177.  
  178. If you would like more information, or if you have any comments on our
  179. products, please contact us.  We can be reached through a variety of
  180. electronic means, as well as by mail.
  181.  
  182.     Telephone:
  183.        Credit card orders can be made by calling (415)493-2430 weekdays
  184.        from 10 AM to 6 PM Pacific Time.
  185.  
  186.     High Energy BBS:
  187.        The fastest way to reach us is through the High Energy BBS.  Set
  188.        your modem to 14,400 bps (or any lower speed), N-8-1, and dial
  189.        415-493-2420.  The BBS is open to the public -- you don't need to
  190.        be a registered user of any our products to access the system.
  191.        Feel free to browse the message conferences and libraries on the
  192.        BBS; you may be able to find the answer to your question without
  193.        having to wait for a reply.  Address specific questions to SYSOP.
  194.        PCPursuit users:  the High Energy BBS can be reached from the
  195.        San Jose (CASJO) outdial.
  196.  
  197.     Internet:
  198.        support@hinrg.starconn.com
  199.  
  200.     CompuServe:
  201.        >internet:support@hinrg.starconn.com
  202.  
  203.     USPS:
  204.        High Energy Software
  205.        P.O. Box 50422
  206.        Palo Alto, CA  94303
  207.  
  208.